OpenMLBB SDK Docs

OpenMLBB Endpoint

SDK call mapping, request requirements, and Python example.

Every card documents the SDK call from OpenMLBB and mirrors API path/query/body requirements.

GET Hero Detail

/openmlbb/mlbb/heroes/{hero_identifier}

Open Only This

API Path: /api/heroes/{hero_identifier}

Get detailed information for a specific hero by ID or name. Supports query parameters for pagination and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes hero details:

  • records: Array of hero entries, each containing:
      • _id: Unique record identifier.
      • caption: Caption or localized label.
      • configId: Configuration ID.
      • createdAt: Creation timestamp.
      • createdUser: Creator username.
      • data:
          • head: Hero portrait image URL.
          • head_big: Larger hero portrait image URL.
          • hero:
              • data:
                  • heroid: Hero ID.
                  • name: Hero name.
                  • story: Hero lore or background story.
                  • painting: Hero splash art image URL.
                  • speciality: Array of hero specialties (e.g., Support, Crowd Control).
                  • abilityshow: Array of ability stats.
                  • difficulty: Difficulty rating.
                  • heroskilllist: Array of skill sets, each containing:
                      • skilllist: Array of skills:
                          • skillid: Skill ID.
                          • skillname: Skill name.
                          • skilldesc: Skill description.
                          • skillicon: Skill icon URL.
                          • skillcd&cost: Cooldown and mana cost.
                          • skilltag: Array of tags:
                              • tagid: Tag ID.
                              • tagname: Tag name (e.g., Burst, CC).
                              • tagrgb: Tag color.
                          • skillvideo: Skill video URL (if available).
                  • roadsort: Lane assignment metadata:
                      • road_sort_id: Lane ID.
                      • road_sort_title: Lane title (e.g., Mid Lane).
                      • road_sort_icon: Lane icon URL.
                  • sortid: Role assignment metadata:
                      • sort_id: Role ID.
                      • sort_title: Role title (e.g., Mage).
                      • sort_icon: Role icon URL.
                  • smallmap: Hero smallmap image URL.
                  • squarehead: Square portrait image URL.
                  • squareheadbig: Larger square portrait image URL.
          • hero_id: Unique hero identifier.
          • relation:
              • assist:
                  • desc: Description of assist synergy.
                  • target_hero_id: Array of hero IDs assisted.
                  • target_hero: Array of assisted hero metadata (images).
              • strong:
                  • desc: Description of heroes countered.
                  • target_hero_id: Array of hero IDs countered.
                  • target_hero: Array of countered hero metadata (images).
              • weak:
                  • desc: Description of heroes that counter this hero.
                  • target_hero_id: Array of hero IDs that counter.
                  • target_hero: Array of counter hero metadata (images).
          • url: Official lore or profile URL.

This endpoint is useful for:

  • Displaying comprehensive hero profiles.
  • Analyzing hero abilities and skill tags.
  • Understanding hero synergies and counters.
  • Linking lane and role assignments to gameplay analysis.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.mlbb.hero_detail("miya", size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
hero_identifier path string yes -
size query integer no 20
index query integer no 1
lang query string no en